package com.rbac.admin.service.system;

import com.baomidou.mybatisplus.extension.service.IService;
import com.rbac.admin.entity.system.SystemDept;
import com.rbac.admin.vo.system.DeptVO;

import java.util.List;
import java.util.Map;

/**
 * 部门服务接口
 *
 * @author rbac-admin
 * @since 2024-07-18
 */
public interface DeptService extends IService<SystemDept> {

    /**
     * 查询部门列表
     *
     * @param dept 部门查询条件
     * @return 部门列表
     */
    List<DeptVO> getDeptList(SystemDept dept);
    
    /**
     * 查询部门树结构
     *
     * @param dept 部门查询条件
     * @return 部门树
     */
    List<DeptVO> getDeptTree(SystemDept dept);
    
    /**
     * 根据ID查询部门
     *
     * @param deptId 部门ID
     * @return 部门信息
     */
    DeptVO getDeptById(Integer deptId);
    
    /**
     * 检查部门名称是否存在
     *
     * @param deptName 部门名称
     * @param excludeDeptId 排除的部门ID
     * @return 是否存在
     */
    boolean checkDeptNameExists(String deptName, Integer excludeDeptId);
    
    /**
     * 检查部门编码是否存在
     *
     * @param deptCode 部门编码
     * @param excludeDeptId 排除的部门ID
     * @return 是否存在
     */
    boolean checkDeptCodeExists(String deptCode, Integer excludeDeptId);
    
    /**
     * 检查部门是否有子部门
     *
     * @param deptId 部门ID
     * @return 是否有子部门
     */
    boolean hasChildDept(Integer deptId);
    
    /**
     * 检查部门是否有用户
     *
     * @param deptId 部门ID
     * @return 是否有用户
     */
    boolean hasUserByDept(Integer deptId);
    
    /**
     * 构建部门树
     *
     * @param deptList 部门列表
     * @return 部门树
     */
    List<DeptVO> buildDeptTree(List<DeptVO> deptList);
    
    /**
     * 获取用户列表（用于部门负责人选择）
     *
     * @return 用户列表，包含id和name
     */
    List<Map<String, Object>> getUserList();
} 